home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / pcb / kmail293.zip / NETWORK.DOC < prev    next >
Text File  |  1991-06-14  |  7KB  |  160 lines
  1. Multi-Node Installation
  2. -----------------------
  3.  
  4.       The PCBoard documentation recommends that a unique \PCB base
  5.       directory be created for each node that you are running.
  6.  
  7.       The suggested setup and what I'll use as an example is:
  8.  
  9.       C:\PCB   - Node 1 base PCB directory
  10.       C:\PCB2  - Node 2 base PCB directory
  11.       D:\PCB3  - Node 3 base PCB directory
  12.       E:\PCBx  - Node x base PCB directory
  13.  
  14.  
  15.    1. Create a KMAIL sub-directory to hold the KMAILxxx distribuation
  16.       archive files. This directory is not node specific and you only
  17.       need one of them. (See note later about the KMAIL.OVR file).
  18.  
  19.    2. Create a "unique" \KWORK sub-directory for each node you have.
  20.       Some examples are:
  21.  
  22.       C:\KWORK1   or   C:\PCB\KWORK     -  Node 1
  23.       C:\KWORK2   or   C:\PCB2\KWORK    -  Node 2
  24.       D:\KWORK3   or   D:\PCB3\KWORK    -  Node 3
  25.  
  26.       C:\PCB\KWORK   \
  27.       C:\PCB2\KWORK   > This would also be a valid technique.
  28.       D:\PCB3\KWORK  /
  29.  
  30.       If you have room for everything on one drive, then the following
  31.       would be possible:
  32.  
  33.       C:\KMAIL\KWORK1
  34.       C:\KMAIL\KWORK2
  35.       C:\KMAIL\KWORK3
  36.  
  37.       ***CAUTION***  ***CAUTION***   All files are erased in the WORK
  38.       directory during the mail packet creation process. DO NOT use an
  39.       existing directory that has good stuff in it!
  40.  
  41.  
  42.    3. This item is the same as in the KMAIL.DOC file.
  43.  
  44.  
  45.    4. Create a "unique" KMAILx.CNF for each node you are running.
  46.       This is a standard ASCII text file, parameters start in column 1.
  47.  
  48.       The .CNF files should be placed in the KMAIL sub-directory that
  49.       was defined in step #1 above.
  50.  
  51.       On a multi-node system is it suggested that the .CNF files be
  52.       called something like (KMAIL1.CNF, KMAIL2.CNF, ..... KMAILx.CNF).
  53.  
  54.       LINE 1: Defines the comm port interface.
  55.       LINE 2: Defines the location of the node specific Kwork directory.
  56.       LINE 3: Optional, defines the location of a holding directory if
  57.               you choose to provide pre-zipped packets for callers.
  58.               (The need for this is described in step 10).
  59.  
  60.       Detailed Description:
  61.       ---------------------
  62.  
  63.       Line #1 can be ONE of the two following keywords:
  64.  
  65.         INTERRUPT   ;the best, fastest, for 99% of all users.
  66.         BIOS        ;if interrupt fails to work under some highly
  67.                     ;unusual multitasker configurations, try BIOS.
  68.  
  69.       Line #2 is the path\name of a "unique" scratch work directory.
  70.       If the sub-directory does not exist, it will be created.
  71.  
  72.       Line #3 is optional. If the pre-zip function (explained later) is
  73.       used, this line points to the holding sub-directory. It may be
  74.       any name, but I recommend something like KHOLD. Multi-node
  75.       systems MUST share the same KHOLD sub-directory in order for
  76.       pre-zip packets to be located from any node.
  77.  
  78.  
  79.         Sample KMAILx.CNF - It gets a little complicated to show
  80.                all variations. Just remember, line #2 points to
  81.                the node specific KWORK directory that you defined
  82.                in step 2 above.
  83.  
  84.   KMAIL1.CNF    KMAIL3.CNF
  85.   ----------    ----------
  86.   INTERRUPT     INTERRUPT      Line 1
  87.   C:\PCB\KWORK  D:\PCB3\KWORK  Line 2  <-- Must be unique for each node!
  88.   D:\KHOLD      D:\KHOLD       Line 3  Optional, must NOT be the same as
  89.                                        line 2. Multi-node systems must
  90.                                        share the same sub-directory.
  91.                                        (explained in step 10).
  92.  
  93.   ********************************************************************
  94.   **  Warning   **  Warning  **  Warning  **  Warning  **  Warning  **
  95.   ********************************************************************
  96.   *                                                                  *
  97.   *   ALL FILES ARE ERASED IN THE WORK DIRECTORY DURING PROCESSING.  *
  98.   *   MAKE SURE THE AREA YOU SPECIFY IS A SCRATCH AREA!              *
  99.   *                                                                  *
  100.   ********************************************************************
  101.   **  Warning   **  Warning  **  Warning  **  Warning  **  Warning  **
  102.   ********************************************************************
  103.  
  104.  
  105.    5. You will now need to create a KMAIL batch file for each node.
  106.       Each KMAIL batch file is unique to the node it is running on.
  107.       Basically, the job of the KMAIL batch file is to load the
  108.       Kmail program and identify the appropriate .CNF file to use.
  109.       The .CNF is read by Kmail to determine the correct \KWORK area.
  110.  
  111.       The Kmail batch files are to be placed into the base \PCBx
  112.       directory of each node. The batch files MUST all have the same
  113.       name, but since each is located in a unique directory, that
  114.       is not a problem.
  115.  
  116.       The format of the Kmail command is as follows:
  117.  
  118.       KMAIL KMAILx.CNF C:\PCBx
  119.             │          │
  120.             │          └─────> The location of where to find PCBOARD.DAT
  121.             │                  for this node. This is normally the base
  122.             │                  PCB directory of the node in question.
  123.             │
  124.             └────────────────> The name of the specific .CNF file for
  125.                                the node in question.
  126.  
  127.  
  128.       NODE 1                        NODE 3
  129.       --------                      ----------
  130.       Echo off                      Echo Off
  131.       SET KMAIL=                    SET KMAIL=
  132.       C:                            C:
  133.       CD\Kmail                      CD\Kmail
  134.  ==>  KMAIL KMAIL1.CNF C:\PCB  ==>  KMAIL KMAIL3.CNF C:\PCB3
  135.  ==>  C:                       ==>  D:
  136.  ==>  CD\PCB                   ==>  CD\PCB3
  137.       Board                         Board
  138.  
  139.  
  140.  ===> As you can see, this portion of each KMAIL batch file is unique
  141.       to the node it is running on and needs to be customized to match
  142.       the configuration of your system. Please double check everything.
  143.       There is no end to the grief and misery caused by an error here.
  144.  
  145.  
  146.    6. This and the rest of the items are the same as in KMAIL.DOC
  147.  
  148.  
  149. NOTE: Some multi-taskers or network programs will report a share
  150.       violation trying to open KMAIL.OVR unless the attributes for
  151.       KMAIL.OVR are set to "readonly".
  152.  
  153.       Beginning with KMAIL280, the KMAIL.OVR file will be distributed
  154.       with the "readonly" attribute enabled.
  155.  
  156.       Should the need arise for you to set the readonly attribute
  157.       you can do so with the Dos ATTRIB command.
  158.  
  159.      The syntax is:  ATTRIB +R KMAIL.OVR
  160.